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PREFACE 



1 . 0 


Manual Objectives 


The purpose of the manual is to describe how to set up, 
operate, and maintain the BASEWAY database. Various SA3EWAY 
utility programs are also described. 


2. 0 Aud ienc e 


This manual is for individuals involved in database 
administration or operations, or for programmers who need to 
understand database operations. 


3. 0 Prerequisites 


The reader of this manual should be familiar with she 
VAX/VMS operating system and have some knowledge of a 
high-level programming Language. 


4.0 Structure of This Document 


This manual is organized as follows: 

Chapter 1: Provides an overview of the BASEWAY system. 

Chapter 2: Gives instructions for system startup; 

shutdown, and recovery. 

Chapter 3: Provides information on the use of BASEWAY 
screens. 

Chapter 4: Explains the User Application menu. 



Chapter 5: Explains the System Management menu which 
allows you to define the system configuration, the device 
network, and session defaults. 


Chapter 6: Explains the System Status 

contains various BASEWAY utility programs. 


menu which 
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Chapter 7: Lists and describes BASEWAY system user 
messages. 

5. C Associated* documents 

Further information on various topics covered in this 
manual may be found in the following manuals: 

o BASEWAY Insta1lation Guide/Rslease Notes 

(order number XX-12345-01). 

o PROGRAMMABLE DEVICE SUPPORT Installation 

Guide/Release Notes 

(order number XX-12365-01) 

o SHOP FLOOR GATEWAY Installation Guide/Release Notes 
(order number XX-12355-01) 
o BASEWAY Sustem Programmer's Guide 
(order number XX-12346-01). 

o PROGRAMMABLE DEVICE SUPPORT User 'a Manual and 
Utilities Guide 

(order number XX-12367-01) 

o VAX. DATATRIEVE User's Guide 

(order number AA-K080A-TE) 

<3 ALLzIltil Office Menu User's Guide 

(order number AA-N321A-TE). 




CHAPTER 1 


OVERVIEW OF BASEWAY 


i. 1 Overview 


The BASEWAY system provides tools for the d 
of complex manufacturing applications where 
communication with shop floor devices is vita 
reduce application development and maintenan 
significant amounts of application contro 
device-specific communications code. 
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The SASEWAY product works together with DIGITAL's SHOP FLOOR 
GATEWAY product. While BASEWAY provides application program 
communications and control functions# the SHOP FLOOR GATEWAY provides 
the actual communications interface to shop floor devices. A global 
database contains all programmable device definitions# and programs in 
ach application can access a device simultaneously. The product can 
concurrently support up to four gateways. 


A wide 
control 1ed 
and quality 


range of manufacturing applications can be 
with BASEWAY including inventory control# 
control. 


developed and 
part tracking# 
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Figure 1. System Overview 
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CHAPTER 2 


BASEWAY STARTUP/ SHUTDOWN, AND RECOVERY 


The BASEWAY's Application Control facility provides a controlled 
environment for application startup and shutdown. During application 
startup, a script file is executed. This file may create logical 
names and mailboxes, start application programs, or perform DCL 
commands. An application program may be monitored or unmonitored. If 
a monitored application program fails, the BASEWAY Application Control 
facility logs the event and begins an orderly shutdown of all other 
application processes. 


2.1 Startup Procedures 
2. 1. 1 Application 


The purpose of the Application startup procedure is to start the 
application to which all polled data will be sent. 

For each application on the system, there should be one manager 
account with sufficient authorization (SYSPRV and DETACH) to start up 
the BASEWAY system. After logging in to this account, the user 
proceeds as shown: 

cr 

Username: xxxxx cr 

Password: cr 


* @BSL$SYSTEM:APP x x x x 
Starting BASEWAY System 

XRUN-S-PRQC-ID, identi f ication of created process is 00301009 
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BASEWAY Startup* Shutdown! and Recovery 


$ 


See Chapter 3 of 
complete Information. 


the BASEWAY Insta1lation Quide/Release Notes 


for 



2. 1. 1. 1 Application Startup Verification - 

If the system starts properly* several messages will be printed 
on the system console. For example: 

%OPCQM* 02—-JAN— 1984 00: 00: 00. 01* ... 

BASEWAY Starting 


When these messages have finished printing* you can further 
verify that proper system startup has occurred by entering the SHOW 
SYSTEM command: 

* SHO SYSTEM 


VAX/VMS V3. 4 Processes on 

2-JAN- 

1984 

23:11:03.79 Uptime 7 08: 

54: 54 

Pid 

Process Name 

UIC 

State 

Pri 

Dir. I/O CPU 

Page fits Ph.H 

OQO10000 

NULL 

000* 000 

COM 

0 

0 

02: 05: 12. 84 

0 

0 

0A10001 

SWAPPER 

000* 000 

HIB 

16 

0 

00: 07:20. 09 

0 

0 11 

008F0030 

EVENT LOO 

243* 002 

LEF 

4 

7 

00: 00: 00. 27 

64 

10r | 

00D20031 

GATE IN.IT 

243* 002 

LEF 

7 

23 

00:00:00. 49 

82 

12^ 

0CBS0O32 

DATA PRQC 

243* 002 

LEF 

4 

3 

00: 00: 00. 24 

55 

100 S t 

01270034 

NET INTER 

243* 002 

HIB 

10 

3 

00: 00: 00. 27 

56 

113 S 1 

025F003S 

EVENT PROC 

243* 002 

LEF 

6 

6 

00:00:00.91 

15 

200 

0003003C 

NETACP 

001* 004 

HIB 

10 

3788 

00: 04: 24. 38 

18078 

116 


If error messages are displayed* check Chapter 7 for an 
explanation and suggested method of recovery. 
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2. 1.2 SHOP FLOOR GATEWAY 


The purpose of the SHOP FLOOR GATEWAY startup procedure is to 
equest initialization of the programmable device database which 
causes the SHOP FLOOR GATEWAY to be loaded with the desired system 
configuration. 

The user may start the SHOP FLOOR GATEWAY (collector) system in 
one of tuio ways: (1) by using the boot switch on the PDP-11 processor 
or (2) by entering the DECnet TRIGGER function on the VAX. 

2. 1.2. 1 Using the PDP-11 Processor Boot Switch - 

To use the boot switch method* first locate the key on the front 
panel of the PDP-11 processor and make sure that it is set to the 
LOCAL position. Next* locate the rocker switch on the front panel. 
Push the rocker switch to the right (BOOT) and release it. Be sure to 
move the key back to the LOCAL DISABLED position. 


2. 1. 2. 2 Using the TRIGGER Function - 

To use the TRIGGER function method* enter the following commands: 
* NOP 

NCP> TRIGGER NODE GATE01 
NCP> - N Z 


i. 1. 2. vi 

The 

o 

0 

0 


Execution of Initialiration .Tasks - 

SHOP FLOOR GATEWAY initialization proceeds in several stages: 
RSX-11S system image is downloaded by DECnet 
initialization tasks on the gateway are run 
polling database is downloaded 


DECnet Downloading— When the boot begins* DECnet responds to the 
gateway node's actions by downloading the specified system image. The 
NCP command may be used to display the characteristics of the node 
(see 3ASEWAY Installation hanual/Release Notes ). The example console 
dialog shown on the following page illustrates the downloading of a 
gateway named GATEG1* with a Node ID of 35* from an application named 
GEOVAX: 


3ASEWAY Startup/ Shutdown/ and Recovery 


%OPCOM# 02-JAN-1984 15:30:53.64# message from user DECNET 

DECnet event 5. 1/ remotely initiated state change 
From node 33 (GEOVAX)# 02-JAN-1984 15:30:53.58 
Circuit DMC-O# Old state * Running# New state ■ Maintenance 

/COPCOM# Q2-JAN-1984 00:00:03.00# message from user DECNET 
DECnet event 0.3# automatic line service 
From node 33 (GEOVAX)# 02-JAN-1984 15:30:57.27 
Circuit DMC-O# Load# Requested# Node * 35 (GATE01) 

File a SECDMC#SYS# Secondary loader 

/COPCOM# 02-JAN-1984 15:31:09.62# message from user DECNET 

DECnet event 0. 3# automatic line service 

From node 33 (GEOVAX)# 02-JAN-1984 15:30:57.41 

Circuit DMC-O# Load# Successful# Node * 35 

File - SECDMC. SYS# Secondary loader (GATE01) 

%OPCQM# 02—JAN—1984 15:31:17.89# message from user DECNET 
DECnet event 0.3# automatic line service 
From node 33 (GEOVAX)# 02-JAN-19S4 15:30:57.72 
Circuit DMC-O# Load# Requested# Node » 35 (GATE01) 

File * TERDMC. SYS# Tertiary loader 

7.QPC0M# 02-JAN—1984 15:31:26.09, message from user DECNET 
DECnet event 0. 3# automatic line service 
From node 33 (GEOVAX)# 02-JAN-19S4 15:30:58.22 
Circuit DMC-O# Load# Successful# Node * 35 (GATE01) 

File * TERDMC. SYS# Tertiary loader 

7.0PC0M# 02—JAN-1984 15:31:34.32# message from user DECNET 
DECnet event 0.3# automatic line service 
From node 33 (GEOVAX)# 02-JAN-1984 15:30:58.84 
Circuit DMC-O# Load# Requested# Node * 35 (GATE01) • 

File a SFG$SYSTEM: GATEWAY. SYS# Operating system 

XGPCOM# 02-JAN—1984 15:31:42.92# message from user DECNET 
DECnet event 0.3# automatic line service 
From node 33 (GEOVAX)# 02-JAN-19S4 15:31:11.09 
Circuit DMC-O# Load# Successful# Node ■ 35 (GATE01) 

File a SFGSSYSTEM: GATEWAY. SYS# Operating system 

7.0PC0M# 02—JAN—1984 15:31:51. 52# message from user DECNET 
DECnet event 5.0# locally initiated state change 
From node 33 (GEOVAX)# 02-JAN-1984 15:31:11.38 
Circuit DMC-O# Old state » Maintenance# New state * Running 

7.0PC0M# 02—JAN—1984 15:31:59.08# message from user DECNET 
DECnet event 4.10# circuit up 

From node 33 (GEOVAX)# 02-JAN-1984 15:31:21.45 
Circuit DMC-O# Adjacent node * 35 (GATEOl) 



BASEWAY Startup* Shutdown.* and Recovery 


Execution of Initialization Tasks—Once the SFG has been loaded 
with its system image.* several programs are run to initialize drivers* 
databases* etc. 


Polling Database 
running BASEWAY to 
printed on the console 


Down 1oading—Gateway initialization 
establish contact with it. Several 
at this point. For example: 


allows 
messages 


the 

are 


Y.OPCOM* 02-JAN-1984 15:12:19.92* message from user 

Lost communications with Device Set DEVICE SET 1 

%OPCOM* 02-JAN-19S4 15:12:24.04* message from user 

Lost communications with Gateway GATE01 

/COPCOM* 02-JAN-1984 15: 12: 27. 73* message from user 

Connected to Gateway GATE01 

7.0PC0M* 02—JAN—1984 15:12:36.93* message from user 
Connected to Device Set DEVICE SET 1 


TEST APPLICATION 
TEST APPLICATION 
TEST APPLICATION 
TEST APPLICATION 


The last message indicates that the application has loaded the 
polling database into the SHOP FLOOR GATEWAY. Depending on the number 
of device addresses and programmable devices defined* and the current 
system load* this can take from several seconds to several minutes. 

When the loading has been completed* a message is displayed on 
the gateway console indicating that polling is initialized. 
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2. 2 Shutdown Procedures 


The system will run independently until a process stops 
abnormally or until the system receives a MSG$_SHUT interprocess 
message. To stop the current application, the user should RUN 
SSLSSYSTEM: UTLAPPSTP from the system manager's account. This does not 
log the user off. 


2. 3 Restart/Recovery Procedures 


2. 3. 1 Application 


When the application comes up again* the gateway system will 
continue to process data; it is not necessary to reload the gateway. 

WARNING: Data may have been lost during the period that the 
system was down. However* the gateway will start sending data as soon 
as the application is back online. 

If any of the application or 3ASEWAY processes should abort or 
exit* the control process (EVENT_PRGC) will shut down the rest of the 
application (in other words* all processes must be running). 


2. 3. 2 SHOP FLOOR GATEWAY 


If the SHOP FLOOR GATEWAY system goes down* it may also be 
rebooted without bringing down the application. 
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CHAPTER 3 


UNDERSTANDING 3ASEWAY SCREENS 


3 . 1 Introduction 


BASEWAY screens utilize Digital's VAX Forms Management Sustem 
(VAX FMS). 

3.2 Screen Layout and Notation 


To give you a better idea of the format of BASEWAY screens/ 
Figure 2 shows a "generic" screen layout. 


program library name report name 

I program page 


time 

date 


user input field 


display field 


A X AX A aA X A A A X 


me s sage s 



Figure 2. Example Form Layout 
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Understanding BASEWAY Screens 

3.2.1 Input Fields 

User input fields are preceded by the ">" character. . 

I | 

! Gateway Node Name> 

I 5 

t $ 

3.2.2 Display Fi»Ids 

Display-only fields are preceded by a " (colon) character. 
Information in display-only fields is put there by the program. For 
example* 

I 

I 

' Device Name: _ 


3. 3 Keyboard and Key Usage 

Characters may be entered in 
characters that are required to 
sy stem. 

3. 4 Displaying the BASEWAY Menu 

System managers should issue 
main menu for BASEWAY* the "System Overview" menu. 


either upper- or lowercase* all 
be uppercase will be modified by the 




the following command to display the 


* RUN BSL*SYSTEM:MENU 







Understanding BASEWAY Screens 


Qther users will see this menu displayed immediately after login. 


menu 


page 1 



APP 

User Application 

SYS 

Sy stem 

Management 

STS 

System 

Status 


EXIT Leave BASEWAY System 


9: 00 AM 
14—JUN—84 

application name 

BASEWAY Application Bus 

System Overview 


Type choicer _ 

Then press RETURN 


You may now enter the letters for the desired menu item. They 
are shown in uppercase letters on the far left side of the menu 
screen. 

IMPORTANT: In this manual# the word "enter" means type the 

desired character(s) and then press the RETURN key. 

Step-by-step instructions for using each of these items is given 
in Chapters 4* 5# and 6. 


.5 The EXIT Menu Item 


To leave the BASEWAY system# enter the word# EXIT. You will be 
returned to the prompt. 

NOTE: Within the BASEWAY system# letters denoting any valid menu 
item# including EXIT# may be entered at the Type Choice} prompt. It 
is not necessary to return to the menu the item is listed on. 








Understanding BASEWAY Screens 


3. 6 Keypad Function Keys 

3.6. 1 Location of Keypad Function Keys and Associated Keyboard Keys 

In the figure beloui# the characters enclosed in parentheses 
denote what is actually printed on the key. 

Note: On keys showing two functions# the bottom (alternate) 

function is obtained by pressing the PF1 key first. 



2 2 
IPrev. 1 

{Field I 
!(BACK : 

{ SPACE)J 

!activate 
!alt. key 
!function 
! (PF1) 

{ Help ! 

I (PF2) { 

i i 

i . 

i i 

i i 

• 

(PF3) ! 

1 

1 

1 

1 

'Update 

I (7) 

1 

l 

< . 

• • 

i (S) 

t 1 

1 t 

j - --- i 

11 11 F 

Print { 
(9) 

°rintAl1 * 

■H—■ mmm 


{Cancel 

■ r ■* '™ ■ ™ p 

{Select ! 

^ mm mm M mm mm 

Delete i 

• Next 

l - b 

! (4) 

(5) I 

(6) ! 

{Field 

! {Erase I 

1 

1 

i i 

• i 

i 

i 

1< TAB > 

1 .‘Char ! 

1 

« 

i . 

< i 

* 

. 

i -- 

+ {(DELETE)! 


■+—b 

——— —-H 



.'Frstpag 

JNextpag ! 

i 

i 



{ (1) . 

! C2.) .* 

(3) ! 



•Lastpag .’Prevpag ? 

i i i 

• i i 

I 

« 

1 


•Erase ! 

1 1 

• 1 

1 

1 


{Field ! 

{ Exit Screen ! 

(. ) 


{(LINE ! 

{ (0) 

1 

• 

f 

1 


I FEED) 1 

f 

r 

i 

1 

f 



1 

i 

t 

t 

t 

l 




(PF4) 


(—) 




(# ) 


——h 


( ENTER) 


Figure 3. Keypad and Associated Keys 
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3.6.2 Explanation of Keypad Function Keys 


NOTE: For user terminals with keyboard overlays* "PFl” is 
equivalent to the GOLD key. The letters "KP" denote '’Keypad' 1 keys 
which are the rows of keys directly below the PF keys. 

Generally* where you are instructed to press two keys* e. g. * 
press PFl + KP1 keys* you should press the first key and then press 
the second key. An exception to this is CTRL/R* which requires you to 
press the CTRL key and* holding it down* type "R". 

Those function keys used frequently in the BASEWAY editors are 
summarized in the following section. 
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3.6.3 Commonly Used Keypad Function Keys 


The following is a description of the more frequently used k ey 2 ad 
keys as they apply to the BASEWAY editors. A complete list of keypad 
function keys is given in Section 3.6.0. 1 beloui. 

When you want to leave an editor* remember that you must press 
Keypad 0. 


Select - Keypad 5. Pressing this key when the cursor is 
positioned in a field which allows a list of the currently defined 
names to be displayed. Using the Select function minimizes the need 
for typing. r/\)y (?e im'H) many devices • irvWicLrc! a hfclp -£uacfion • 

! Current Applications « 

I l 

! 1 FACTORY1 

J 2 FACT0RY2 

J 3 FACTORY3 


Selection > 0 



At the prompt* you may enter the number of your selection, or 
press the RETURN key to go back, to the field you came from with no 
selection made. 

To see if there are additional items in the above list* press 
Keypad 2. Press Keypad 1 to go back to the beginning of the list. 

data on the 
are oerining. 
Keypad 5 is 


Keypad 6 — Delete. Pressing this key will cause a definition to 
be deleted. The name must have been previously defined bo be deleted. 
The user will be queried before deletion occurs. 


Keypad 7 - Update. Pressing this 
screen to be associated with the part 
Once defined* the associated data will 

pressed. ^ ckancp cftecW urvtU UPX>AT^ 


key causes the 
of the system you 
be displayed when 






Keypad 4 - Cancel. This key causes information typed on the 
screen to be erased. The cursor will return to the first field on the 
screen. 









vnairscanamg screens 

Keypad 0 - Exit Screen. This key causes a menu to be displayed 
and may be selected at any time. 

BACKSPACE - Move cursor back to previous field. 

LINEFEED - Erase value displayed in current field. 
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3.6.4 Complete List of Keypad Function Keys and Associated Keys 


I TO ACCOMPLISH THIS 


'move to next field 


•move to previous field 


.'erase contents of input field 


•'exit screen 


!get help 


.‘restart screen 


'move to first page of utility 


•'move to last page of utility 
lor show more items in list 


.'move to next page of utility 

.'move to previous page of 
•'utility or show previous items 


'cancel changes made to 
{displayed screen 

'delete definition 


•'send definition# display new 
I screen 

.'print copy on line printer 


•print copy of all screens 


.'repaint the screen 


DO THIS . . 


press TAB 


press BACKSPACE 


press LINEFEED 


press KPO key 


press PF2 key 


press PF1 + KPO keys 


press KP1 key 


press PF1 + KP1 keys 


press KP2 key 
press PF1 r KP2 keys 


press KP 4 key 


press KP6 key 


press KP7 


press KP9 key 


press PF1 + KP9 


press CTRL + R keys 
(CTRL/R) 
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3. 7 HELP Function 


Two levels of user help are available: help for the field in 
which the cursor is currently located (one-line help) and help for an 
entire screen (help screen). When you press the PF2 (Help) key once/ 
◦ne-line help is displayed at the bottom of the screen. When you 
depress the Help key tu*ice> the current screen clears and a full help 
screen is displayed. Help screens are available for all BASEWAY 
reports and utility programs. 


3. 7. 1 Format of Help Screen 


The format of a help screen is similar to that of a normal 
display screen with some exceptions: 

o The word "HELP" appears in the screen header. 

o The phrases, "Press HELP for more help, or RETURN to 
continue. " or "Press RETURN to continue", may appear on the 
last line of the help screen. 


3.8 Error Signaling and Recovery 

Typing errors and invalid uses of editing and field termination 
functions are signaled by a "beep" of the terminal bell. In addition, 
a message may be displayed at the bottom of the screen. 

Some fields may not be modified by the user; the system will 
skip over these fields or the termirfal may "beep" if there are no more 
valid fields to skip'to. 
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CHAPTER 4 


USER APPLICATION MENU 


When BASEWAY is installed/ this menu item runs the program 
BSL^SYSTEM:UTLNQTYET/ which prints a message and exits. 

Once your application has been developed/ its name can be 
substituted for this menu item/ and the named data updated so that 
your new application menu will be invoked here. 

The User Application menu is displayed when you enter the letters 
"APR" in the “Type Choice>" field. 



c 
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CHAPTER 5 


SYSTEM MANAGEMENT MENU 


NOTE: In the sections uihich folloui/ that portion of the system 

being discussed is outlined in asterisks (***). 

IMPORTANT: Redefinitions to the system configuration are 

effective immediately and are dynamic. 

The System Management menu is displayed when you enter the 
letters "SYS" in the "Type choice>" field. 


' menu 
l p a g e 3 



10:59 PM! 
14—JUN—84! 

f 




application name i 

! EDTC 

Define 

System Configuration 

1 

i 

! EDTN 

Define 

Device Network 

BASEWAY J 

1 EDTS 

Define 

Session Defaults 

1 

i 

System Management ! 


Type choice> 

Then press RETURN 


The following sections explain the use of each of the above menu 
items. 
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System Management Menu 


5. 1 Define System Configuration (EDTC) 


menu 
page 5 


16:49 AM 
29-JUN-B4 


EDTAPP 

EDTSAT 

EDTSET 


Define Application 
Define Qa teway 
Define Device Set 


application name 
BASEWAY*App1icat ion Bus 
Define System Configuration 


4 *— 


Type choice> 

Then press RETURN 








System Management Menu 


5. 1. 1 Define Application (EDTAPP) 


This editor lets you define the physical configuration of an 
jpplication. You must give a unique name to the application# and you 
must associate at least one VAX Node name with the application. Up to 
four nodes may be defined. 

Enter the letters “EDTAPP'' at the Type choice> prompt to display 
this screen. 

NOTES: 

o An application can run on only one system at a time. 

o The command file BSL*SYSTEM:DEFINEAPP. COM should be used 
initially to create an application definition for an 
application that will be run on the current DECnet node. 
Besides creating the BASEWAY definition# DEFINEAPP. COM also 
creates CMS directories# the application system audit data 
file# and some command files used in starting the 

app1ication. 
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Figure 4. Editing an Application 
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System Management Menu 


5. 1. 1. 1 Adding an Application - 

1. Press Keypad 5 to Select an Application name* or type in a 
name (up to 16 characters)* then press TAB. 

2. (optional) Type in a description of your application (up to 

32 characters)* then press TAB. Notice that the display 
fields Defined: and Updated: will be filled in with today's 
date and that the By: field will be filled in with your user 

name. 

3. Type in at least one Primary VAX Node name to be associated 
with the application (up to 6 characters permitted) and press 
TAB. 


4. Enter up to three additional (alternate) VAX node names. 

NOTE: Alternate nodes are other DECnet nodes that are 
capable of running this application. If you define your 
application to run on more than "one node* no database 
definitions will need to be changed to switch configurations 
when a particular computer is unavailable. 

5. Press Keypad 7 to update the database with the application 
and its associated VAX node(s). 


NOTE: Each VAX Node name must be unique* i. e. * names 

should NOT be duplicates. 

6. A message stating that the application has been defined will 
bedisplayed. 


5. 1. 1. 2 Deleting an Application - 

REMINDER: The application must be known to BASEWAY before it can 

be deleted. If you simply wish to start over.- press Keypad 4 
(Cancel). 

1. After the Define Application screen has been displayed* press 
Keypad 5 to select a current application. The cursor will 
move to the Description field. 

2. Now press Keypad 6 to delete the application* its associated 
data* and any polling sets and device addresses referencing 
the application. 

3 A message stating that the application and its associated 
device addresses and polling sets have been deleted will be 
d isplayed. 
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edtapp Define Application 

page 1 or 1 


00:01 AM 
14—JUN—84 


Application > TEST FACTORY 
Description > Our experiment 


Primary Node > FACVX1 
Alternate Node > 
Alternate Node > 
Alternate Node > 


Defined 

Updated 

By 


14-JUN—84 
14-JUN—84 
R. S. NOW 


Example Application Definition 
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System rlanag ement Menu 


5. X. 2 Define Gateway (EDTGAT) 


This editor allows you to define the PDP-11 processor node name 

Enter the letters •''•EDTOAT*' at the Type choice> prompt, 
display this screen. 


to 



D»0 H2nO"0^ 


System Management Menu 
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{ APPLICATION ! 
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Figure 5. Editing a Gateway 
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System Management Menu 


5. 1.2. 1 Adding a Gateway - 

1. Press Keypad 5 to select a current gateway Node name; 
in a gateway Node name (up to 6 characters). 

2. (optional) Type in a description of the gateway (up 
characters). 

3. Press Keypad 7 to update the BASEWAY database. 

4. A message stating that the gateway has been defined 
displayed. 


5. 1. 2. 2 Deleting a Gateway - 

1. After the Define Gateway screen has been displayed 
Keypad 5 to select the desired gateway Name. 

2. Press Keypad 6 to delete the gateway Node name. 

3. A message stating that the gateway has been deleted 
displayed. 


or type 
to 32 

will be 

; press 

will be 
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edtgat 
page 1 of 1 


Define Gateway 


9: 05 AM 
14-JUN-84 


Gateway Name> GATE01 
Description^' Special test gateway 

Date Defined:14-JUN-S4 
Date Updated: 14-JUN-S4 
By: R. S. NOW 


Example Gateway Definition 










System Management Menu 


5. 1. 3 Define Device Set (EDTSET) 


A device set is a group of devices that are known to a gateway, 
his screen is used to define a device set by associating particular 
gateway nodes with it. A device set may have up to four gateway nodes 
associated with it. A gateway node may have up to four device sets 
associated with it. 

Normally* each gateway has one device set associated with it* and 
each device set is associated with only one gateway. 

Enter the letters "EDTSET" at the Type choice> prompt. 
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Figure 6. Editing a Device Set 
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System Management Menu 


5. 1. 3. 1 Adding a Device Set - 

1. Press Keypad 5 to select a current Device Set name/ or type 
in a new name (up to 16 characters permitted). 

2. (optional) Press TAB to move to the Description field and 
enter up to 32 characters. 

3. Press TAB to move to the first Gateway node Name field. 

4. Type in at least one Gateway node Name to be associated with 
the device set. The name must previously have been defined. 

5. Enter up to three additional Gateway node Names/ then press 
Keypad 7 to define the Device Set and its associated Gateway 
nodes. Each node name must be unique. 

NOTE: The three additional Gateway name fields may be 

used to designate alternate or additional gateways that might 
be capable of communicating with this device set. This will 
apply to those systems which are able to switch programmable 
devices f-rom one gateway to another. 

6. A message stating that the Device Set is defined will be 
displayed. 


5. 1.3.2 Deleting a Device Set - 

1. After the Define Device Set screen has teen displayed/ press 
Keypad 5 to select the Device Set name you wish- to delete. 

2. Press Keypad 6 to delete the Device Set. 

3. A message stating that the Device Set and its associated 
nodes have been deleted will be displayed. 
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ledtset Define Device Set 06: 15 | 

\ page i of 1 02—JAN* 

r 

t ■. 

i +-+ j: 


Device Set > DEVICE SET 1 Gateway Name > GATED1 

Description^' The first device set Gateway Name > 

Gateway Name > 

Data Defined-: 02-JAN-94 Gateway Name > 

Date Updated: 02-JAN-S4 
Sy: KY 


—| 


Example Device Set Definition 
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5.2 Define Device-Network (EDTN) 


Programmable devices may be defined interactive1y using the 
refine Device Network menu option. Attributes assigned to the 
programmable devices are checked for validity when the device is 
defined. Up to 9000 programmable devices may be defined. 

Individua1 pisces of data in a programmable device are defined 
interactively and are termed "known points". Any address in a 
programmable device may be read or written when referred to by 
address/ but known points may be referred to by point name. 

Known points may be defined as monitor/ control, or both. 
Monitored points are sampled at user-specified intervals by the SHOP 
FLOOR GATEWAY. Controlled points are known points that are written to 
by application programs. 

To view the Define Device Network menu/ enter the letters "EDTN" 
at the Type choice> prompt. The Define Device Network menu will be 
displayed. 


menu 
page 6 


EDTDEV Define Programmable Device 

EDTADR Define Device Address 


10:04 AM 
02-JUN-64 


application name 
BASEWAY Application Bus 
Define Device Network 


Type choice> 

Then press RETURN 
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Figure 7. 


Editing Device*# Device Addresses# and Point Groups 
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System Management Menu 


5.2.1 Define Programmable Devices (EDTDEV) 


This screen is used to define the characteristics of a shop floor 
rogrammable Device and its associated device addresses. A device set 
must exist before a device may be defined. 

Enter the letters "EDTN" at the Type choice> prompt. 
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1 . 

2 . 

3. 

4. 

5. 

6 . 

7. 

8 . 

9. 

10 . 

11 . 



13. 

14. 


15 . 


Adding a Device - p 

Press Keypad 5 to select a current Device name/ or type in a 
Device name of up to 16 characters. 

(optional) Type in a Device Description (maximum of 32 
characters) and press TAB. 

Press Keypad 5 to select a Manufacturer name. 

Press Keypad 5 to select a Model name. 

(optional) Type in the memory size (up to 9 digits) and press 
TAB. 

(Device Set names must be previously defined. ) Press Keypad 5 
to select a Device Set name and then press TAB. 

Press Keypad 5 to select a Network. 

Type in a Port number (maximum of 2 digits). Port numbers 
may be found on the distribution panel on the back of the 
PDP-11 processor. Now press TAB. 

(optional) Type in a Station number (maximum of 3 digits) and 
press TAB. This number is the programmable device's address 
on a vendor's network. 

(optional) Type in a Contractor name (maximum of 16 
characters) and press TAB. 

(optional) Type in a Location (maximum of 10 characters) and 
press TAB. 

The Installed Date will be displayed as today's date. If you 
wish to change it/ clear the field by pressing LINEFEED. 
Then type in the desired date in the form DAY-MQNTH—YEAR 
(e. g. / 14-JUL-34) and press TAB. 

(optional) Indicate whether this device is a production 
device by typing an "X" in the Production) and press TAB. 

(optional field) Indicate whether you wish the device to be 
enabled by TABbing through the Enabled field (an "X" is 
displayed as the default value). To clear the field/ press 
LINEFEED. 

Press Keypad 7 to define. 
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16. 

5. 2. 1. 2 
1 . 

2 . 


A message stating that the device has been defined will be 
displayed. 


Deleting a Device - 

After the Define Programmable Device screen has been 
displayed* press Keypad 5 to select the current Device name 
you wish to delete. 

Press Keypad 6 to delete the Device name and its associated 
addresses. 
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!edtdev 
page 1 of 1 


Define Programmable Device 


02:24 PI 
02—JAN' 


■+•— 


„ M 

■■ 


h 


Device Name> 
Description> 
Manufacturer> 
Model> 
Memory Size> 
Device Set> 
Netiuor k> 
Por t> 


Contractor> Electro-Cntr 


Date 


1LS0033 

Piston Supply Conveyor Control 
Modicon 
5S4 

000016384 
ASSEMBLY AREA 

Modbus Date Defined: 

04 Date Last Updated: 


Location > 
Installed > 
Production> 
Enabled> 


E-4 

14-JUN-94 


14-JUN-S4 
14-JUN-84 


Station>024 


By: R. S. NOW 




Example Device Definition 
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System Management Menu 


5.2.2 Define Device Address (EDTADR) 


Data from programmable devices is stored in device addresses, 
different programmable devices have different uiays of storing this 
data <i. e. » different “formats"). This device address data can be 
connected with names meaningful to the user (e. g. # Total Parts 
Produced). Thus# a point must be defined for each individual piece of 
data in a device address. 


A point is an individual piece of data in a point group# and may 
indicate if a machine is running# the number of parts that have passed 
through it# etc. 

A point group is a collection of points. Normally# a point'group 
is associated with a particular machine on the shop floor# such as a 
conveyor. 

The three screens that comprise the Define Device Address menu 
option allow you to define device address# point# and point groups. 

NOTE: Interface-type devices# such as A11en-Brad1ey KF# do not 
require device address definition. For nonaddressable devices# such 
as a bar code reader# only one device point may be defined. 

There are three screens associated with the Define Device Address 
editor. If you are not at the last screen and wish to return to a 
previous screen# press BACKSPACE. 

I To display the first Define Device Address screen# enter EDTADR 
at the Type choice> prompt. 


5. 2. 2. 1 Page 1—Define Device Address - 

Press Keypad 5 to select a current device name. 


5. 2. 2. 2 Page 2—Define Device Address - 

1. Press Keypad 5 to select a valid address for this device# or 
type in an address and press TAB. 

2. A default format will be displayed for the device. Press TAB 
to accept the default format# or press Keypad 5 to see the 
list of valid formats for the current address. 

3. Now type a Sampling Interval (default value is one-tenth of a 
second) in the range 0.1-^1800.0 seconds# or press TAB to 
accept the default value. 
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4. Press TAB to continue. 


5. 2. 2. 3 Page 3—Define Device Address - 

NOTE: The information you enter about each point is stored until 

you press Keypad 7 (Update). When you have finished typing in 
information for one point* you can go on to the next by pressing 
Keypad 2. The reverse video area in the format field identifies the 
current part of the device memory that you are defining. To go back 
to a immediately previous point* press PFl + Keypad 2. To go to the 
first point in the device address press Keypad 1* to go to the point 
in the device address* press PF1 + Keypad 1. You can "undefine" a 
currently defined point for this device address by pressing LINEFEED 
to clear the Point Name field. 

WARNING/RESTRICTION: 

! You may not modify a point's type once the point has been 
defined. 

! A point must not be referenced more than once for a point 
group. 


1. Press Keypad 5 to select a current point name* or type in a 
point name of up to 32 characters. Press TAB. 

2. Press. Keypad 5 to select a Point Type and then press TAB. 
Currently supported Point Types are: 

1. control—writing only* no polling 

2. monitor—polling only 

3. both—polling and modification 

4.. trigger—status point format only (monitored) 
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3. The following fields appear for trigger point types: 
Field(s) Meaning 


Active High > active* high state 

Buffer Address > address of buffer 

Count > size of buffer 

Reset Address > address of reset 

bit 

Reset High > active state of 

reset bit 

4. The following field appears for device addresses that contain 
status data: 

Active High > active* high state 


5. The following field appears for device addresses that contain 
string data: 

Count > maximum length of 

string to read 

6. Type in a Point Group Name (normally this name reflects the 
category of machine* e. g. * Conveyor) and press TAB to move to 
the next field. 


7. Type in a description of the point and press TAB. 


8. (optional for Controlled points) Type in the name of the 

BASEWAY Application where you want data from this point to be 
sent and press TAB. 

9. (optional for Controlled points) Type in the name of the 

Message Port that you want to receive the data. 

10. Press Keypad 7 key to update the database with the device 
address and its associated point(s). 

11. A message stating that the device address has been defined 

will be d i sp layed. 
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2.2.4 Deleting Device Addresses and Points - 

1. After the Device Address screen has been displayed* press 
Keypad 5 to select the device address you wish to delete. 

2. Press Keypad 6 to delete. The device address will be deleted 
along with its associated point(s)* unless another device 
address currently references those points. 

3. Respond to the deletion verification question with "Y" or 
“N". 

4. If your response is "Y"* a message stating that the device 
address has been deleted will be printed. 


System Management Menu 


‘edtadr ^ Define Device Address 11:00 AM 

(page! of 3 * 02-JUN-84 


Device Name> 1L80033 


edtadr 
page 2 of 3 


Define Device Address 


11:02 AM 
02-JUN-84 


Device Name: 1LS0033 Sampling Intervals- 0030.0 

Address> 40032 

Format> BINARY VALUE 


i Word containing a named value 


Point Name> PARTS_IN Type> MONITOR 

Point Group."- PISTON SUPPLY CONVEYOR 

Description> Total parts entered this shift 
Application."- PRODUCTION 
Message Port> DATA_PROC 


Example 1. Device Address Definition 
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edtadr 
page 1 of 3 


Define Device Address 


11: 0~ Af 

02-J^ 


Device Name> 1LS0033 


edtadr 
page 2 of 3 


Define Device Address 


11: 02 Af 
02-JUN-3I 


Device Name: 1L90033 
Address} 100 

Format} STATUS POINT 


Sampling Interval> 0010.0 


Point Name> CONVEYOR JAMMED 
Point Group} PISTON SUPPLY CONVEYOR 
Active High> X 

Description} Piston supply conveyor is jammed 
Application^' PRODUCTION 
Message Port} DATA_PROC 


Type> MONITOR 


Example 2. Device Address Definition 
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5.3 Define Seesion _Defaults (EDTS) 


This editor lets you define defaults for both users and 
terminal s. 

Enter EDTS at the Type choice> prompt. The Define Session 
Defaults menu will be displayed. 


+— 


menu 
page 7 


2:00 PM 
14-JUN-84 


EDTUSR Define User Defaults ' application name 

EDTTRM Define Terminal Defaults ! 

! BASEWAY Application Bus 

I 

I 

! Define Session Defaults 


Type choice> 

Then press RETURN 


5. 3. 1 Define User Defaults (EDTUSR) 

Each user is defined to BASEWAY. A user definition contains 
demographic data; user-customization data; privileges; and 

application—specific data. 

The specific attributes that may be defined for each user 
include: 

o user name 

o user's VMS user name 

o nickname 

o address 

o telephone number 

o title or position 
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o department 

o default line printer device 
o password for user verification 
o library for user 

o initial menu form and form library 
o privilege masks 

To display the Define User Defaults screens, enter the letters 
'‘EDTUSR" at the prompt. 

5. 3. 1. 1 Page 1—Define User Defaults - 

1. Press Kaypad 5 to select a user name, or type in a name. Now 
press TAB. The next screen will be displayed. 

5. 3. 1. 2 Page 2—Define User Defaults — 

NOTE: The only field that requires input on this screen is 

Nickname> . 

1. Type in a VMS Username (up to 12 characters). 

2. Type in a user Nickname and press TAB. 


3. 

(optional) Type 
password. Pres 

in up to 
s TAB. 

16 characters 

for 

the 

user 's 

4. 

(optional) Type 
characters) and 

in th e user ' s 
press TAB. 

position or 

title 

(up 

to 20 

5. 

(optional) Type 
characters) and 

in the user's 
press TAB. 

department or 

unit 

( up 

* to 20 

6. 

(optional ) Type 
and press TAB. 

in the user's 

phone number 

(up to 


digits) 

7. 

(optional) Type 
(30 characters 

in up to 3 lines of an address for 
per line). Press TAB. 

this user 

8. 

(optional) Type 

in the name of the user's library 

. and 

press 


TAB. 
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9. (optional) Type in a Root Menu Form name and press TAB. 

10. (optional) Type in a Root Menu Library name and press TAB. 

11. (optional) Type in the default printer name. 

12. Press Keypad 2 to display the next screen. 


5. 3. 1. 3 Page 3—Define User Defaults - 

1. Type in a privilege class for the user: 

- System Manager 

- Engineer 

- Skilled Trades 

- Normal User 

2. Now press the TAB key to move forward through the various 
.fields (press BACKSPACE. to. go back)/, typing an "X 1 ! if.you 
wish this user to have a particular default characteristic 
and pressing LINEFEED to clear a field (omit the default). 

3. Press Keypad 7 (Define) to define the defaults for this user. 
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edtuser 
page 1 of 3 



VMS 


Username} 

Nickname} 

Password} 

Address} 

Address} 

Address} 


Library > 
Root Menu Form} 
Root Menu Library} 
Default Printer} 


Title} 

Department} 

Phone} 


”* 4 * 

fi 


Privilege Class} SYSTEM MANAGER 


Configure system 

Monitor system 

Perform system diagnostics 

Update production library 
Access production devices 


X 

X 

X 

X 

X 


Access programmable device } X 
Write to programmable device}X 
Load; Dump; Compare device } X 
Update device definition } X 


Access programmable 
Update programmable 
Perform path diagno 
Define neui path 


device 

path } 

device 

path } 

sties 

v* N 


> 

hr ary 

y 

1ibrary 

✓* 

ther' s 

1 ibrary} 

gnostic 

s > 


X 
X 


Example User Defaults Definition 
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5.3.2 Define Terminal Defaults (EDTTRM) 


Each terminal device is defined to BASEWAY'. A terminal 

fefinition contains privileges and app1ication-specific data. If both 
a terminal definition and a user definition exist for the current 
session* the terminal definition overrides the user definition. The 
attributes that mag be defined for each terminal include: 

o terminal device name 

o physical location 

o default line printer device 

o initial menu form and form library 

o privilege masks 


To display this screen* enter EDTTRM at the prompt. 


5. 3. 2. 1 Page 1—Define Terminal Defaults - 

1. Press Keypad 5 to select a terminal name* or type in a 
terminal name containing up to 31 characters and ending with 
a colon. (A colon will be appended automatica11y if you x 
forget it). 

2. Press TAB to display, the next screen. 


5. 3. 2. 2 Page 2—Define Terminal Defaults - 

NOTE: All fields on this screen are optional. 

1. Type in a terminal location of up to 16 characters and press 
TAB. 

2. Type in any information specific to your terminal (up to 20 
characters) and press TAB. 

3. Type in the Root Menu Form for this terminal and press TAB 

4. Type in -the Root Menu Library and press TAB. 

5. Type in the Default Printer. 
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6. To go to the next screen* press Keypad 2. 


5. 3. 2. 3 Page 3—Define Terminal Defaults - 

1. Press Keypad 5 to select a Privilege Class Name. The valid 

classes are: System Manager* Engineer* Skilled Trades* and 

Normal User. 

2. Now press the TAB key to move forward through the various 
fields (press BACKSPACE to go back)* typing an "X" if you 
wish the terminal to have a particular default cnaracteristic 
and pressing LINEFEED to clear a field (omit a default). 
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edttrm 
page 1 of 3 


3:01 PM 
14-JUN-04 


Terminal Name> TTA7: 



Terminal location> F-IS 
Device specific^* 

Root Menu Form> MENU_PAGE_1 
Root Menu Library> BSL$MENU:PDSINC 
Default Printer> SYSiFRINT 


{ Privilege Class> SYSTEM MANAGER 

l 

} Configure system > X Access programmable device path 

! Monitor system > X Update programmable device path 

\ Perform system diagnostics > X Perform path diagnostics 

{ Define new path 

! Update production library > X 

! Access production devices > X Access another's library > 

{ Write to another's library > 

i Access programmable device > X Delete entry in another's library> 

Write to programmable device>X Perform library diagnostics > 

Load/ Dump/ Compare device > X 
; Update device definition > X 
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CHAPTER 6 


SYSTEM STATUS MENU 


The System Status menu is obtained by entering the letters "STS" 
in the "Type choice> " field. This menu contains BASEWAY utility 
programs. 


menu 
page 4 


APPSTS 

GATSTS 

AUDIT 

DEVICES 

POINTS 

USERS 

TERMS 


- - 

16:59 AM 
04-JUN-84 


Display Application Status 
Display Gateway Status 
Display System Audit 
Display Defined Devices 
Display Defined Points 
Display Defined Users 
Display Defined Terminals 


Type choice> 

Then press RETURN 


application name 
BASEWAY Application Bus 
System Status 


6. 1 Printing Utility Program Screens 


You can press Keypad 9 to print a copy of the current screen. 
This causes a file (with the shortened name of the utility program and 
no extension) to be created in your directory (e. g. , UTLGATSTS. ). 
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6. 2 Returning To the System Status Menu 

To leave a utility display screen.- press Keypad 0 once# or until 
the System Status menu is displayed. 

6. 3 Returning To the System Overview Menu 


Press RETURN at the prompt to leave the System Status menu. The 
BASEWAY System Overview menu will be displayed. If you wish to stop 
using the BASEWAY system at this point# enter "EXIT" at the prompt. 


6.4 Restarting Gateway Status Utility 


One System Status program# Display Gateway Status# allows you to 
"restart" the utility at any point. This allows you to see a report 
based on new values entered at the program prompt. To restart# press 
PF1 + Keypad 0. 




6.5 Display Application Status (APPSTS) 

The status of an. application is displayed on a series of 
screens. Each screen is dynamically updated every 10 seconds, 
screens (in the order they are displayed) are: 

o Application Overview 

o DECnet Routing Tables 

o Gateway Routing Tables 

o Device Set Routing Tables 

o Application Routing Tables 

o Named Port Tables 

o Temporary Port Tables 

o User Parameters 


eight 

These 


System Status Menu 


6. 5. 1 Application Overview 


The current status modes of an application may be any of the 
fo1lowing: 

o running 

o standby 

o diagnostic 


utlappsts 
page 1 of 8 


Display Application Status 


10:40 A 
02-JAN-S 


Application: 

0ATE01 


ID: 65 Node: 

GATE01 ! 

Started at: 

02-JAN—84 

03: 28 

PM 


1 

l 

1 

Current Mode: 

Running 



1 

t 

1 Intra-App1ication 

i 



Inter-App1icat 

ion ! 

t 

1 

S MBX Messages 

Read: 

.2202 


Messages Read: 

1073 ' 

• MBX Messages Written: 

2303 


Messages Written: 

996 r 

1 

l 




Messages Lost: 

3 l 

S Current NAU 

usage: 

0 


DECnet Errors: 

15 ! 










oysuem nenu 


6.5.2 DECnet Routing Tables 


+— 


utlappsts 
page 2 o-P S 


Display Application Status 


10:40 AH 
02—JAN-84 


! DECnet Node J 

+-*» 

GATE01 


Current Systems 
GATE01, DEVICE SET 1 
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6.5.4 Device Set Routing Tables 


futlappsts 
i page 4 of 8 


Display Application Status 

10:40 AM 
02-JAN—34 


r 

Device Set S Reachable i Gateway ! 



c 

i 

DEVICE SET 1 i YES ! GLGATE 1 
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6. 5. 5 Application Routing Tables 


utlapp sts 
page 5 o4 8 


Display Application Status 


10 : 4 

02-JAN-34 


i Application 


GATE01 


Reachable 

Yes 


DECnet Node! 
GATE01 
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6.5.6 Named Port Tables 


tlap p sts 
age 6 of 8 

Display 

Application Status 


10:40 AM 
02—JAN-84 

Port 

! Port 

! Messages ! 

Messa’ges 

r 

Index 

! Name 

i Read 

Written 

■ 







0010 

{EVENT PROC 

45 

0 

0011 

{EVENT LOG 

1810 

0 

0012 

{NET INTER 

407 

407 

0014 

{GATE INIT 

0 

0 

0064 

!DATA_PROC 

1 

l 

869 

0 
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6.5.7 Temporary Port Tables 


lutlappsts 
{page 7 o-P 


9 


Display Application Status 


10: s 

02—JAN- 



Process 

Name 


Messages 

Read 


Messages 

Written 


0001 


<unknouin> 


427 
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6 . 5. S User Parameters 


futlappsts Display Application Status 10:41 AM 

{page S of 8 02—JAN—84 


I User Flags I User Parameters ! 

+-———--b-— -+ 


1 

Off 

1 

0 

2 

Off 

2 

0 

3 

Off 

3 

0 

4 

Off 

4 

0 

5 

Off 

5 

0 

6 

Off 

6 

0 

7 

Off 

7 

0 

8 

Off 

3 

0 

9 

Off 

9 

0 

10 

Off 

10 

0 


+-—-—-—--—4—-——-—-b 
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6.6 Display Gateway Status (GATSTS) 


The following screens are displayed by this menu choice. They 
are dynamically updated every 10 seconds. The screens/ in the order 
they appear are: 

o Gateway Overview 

o Device Set Tables 

o Polling I/O Statistics 

o Task Mailbox Statistics 

To use this utility/ enter the letters "GATSTS" from the menu. 
Press Keypad 5 to select a gateway (the gateway must be reachable 
through DECnet). 


utlgatsts 
page 1 of 5 


Display Gateway Status 


10: 40 A 
02-JAN-8 


Gateway name> GATEOl 





6. 6. 1 Gateway Overview 


A gateway may have the following statuses: 
o Loaded; the VDR is being loaded V>r4‘ fc&cjirn 


h>Us pe> 

(dujo '-rcm'rs ,itr.) 


o Running; the gateway is running 

o POL Stby; standby* the gateway is not accepting requests 

o GEN Stby; standby* the gateway is not accepting requests 

o DIR Stby; standby* the gateway is not accepting requests 

o Stby; standby* downloading VDR 

o Shutting down; the gateway is shutting down 


A gateway may have the following errors: 
o PD tmd; a device has timed out 

o VDR corrupt; VDR has been corrupted* must be reloaded 
o Net failure; network error 

o Poll missed; a polling cycle has been missed- 
o Resource failure; a task could not access an RSX resource 
o Message error; a task received an invalid message 
o Net full; network could not handle message traffic 
o VDR full; no more VDR blocks can be added to VDR 
o Data buffers full; no more data buffers are available 
o Task aborted; a gateway task has aborted 
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Display Gateway Status 


10:40 AH 
02-JAN-f* 


S Gateway: GATE01 


Id: 

1 Node: GATED1 

1 

« 

{. Started at: 02-JAN-04 

11: 26 

AM 


1 

« 

\ VDR Loaded at: 02-JAN-S4 

11: 26- 

AM 


f 

l Status: Ini t> Running/POL 

Stby* 

GEN# Stby* DIR Stby 

« 

1 

1 

Errors: 




1 

f 


— —■— 



1 

t 

1 

VDR 

GLB 

Network 

1 

f 

1 

! - Blocks Allocated: 

3072 

1023 

Messages Read: 

12 l 

i Blocks in Use: 

1093 

27 

Messages Written: 

4 ! 

! Blocks Free: 

1979 

996 

Messages Queued: 

0 S 

< Largest Block: 


0 

Messages Lost: 

0 1 

! Numb of Sgmnts: 


0 

DECnet Errors: 

0 i 

! Address Naps: 232142 



i 


■— ——— 


-+ 

! Counters last zeroed: 

02—JAN—04 11:26 AM 

i 

i 
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6.6.2 Device Set Tables 


utlgatsts 
page 3 of 5 


Display Gateway Status 


lu:-*n 
02-JAN-84 


{ Current-Device Sets { Defined Device Sets 
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a.6.3 Polling I/O Statistics 


A 


Display Gateway Status 


utlgatsts 
page 4 of 5 

5 Device 1 Requests I Errors ! Timeouts I Last Error 


10 : 41 At 
02 -JAN-S! 


MZ04 

KZOO 

KZ04 


1 

3 

1 


0 

0 

0 
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6.6.4 Task Mailbox Statistics 



utlgatsts 
page 5 of 5 


Display Gateway 

Status 


10:41 AM 
02-JAN-94 

< 

I 

1 

« 

4 — 

Task 

Name 

< Current i Messages ! 

! Status * Delivered • 

Messages I 
Queued i 

Maximum 
Queued 

r 

i 

i 

i 

- 4 - 


TSKWCH 

Running 

3 

0 

i 

NETINT 

Running 

24 

0 

0 

GATEVP 

Running 

21 

0 

1 

DIRSRV 

Running 

1 

0 

0 

POLSRV 

Running 

3 

0 

0 

OENSRV 

Running 

1 

0 

0 

BUSWCH 

Running 

1 

d 

0 

NETSRV 

Running 

0 

0 

0 


+—--——+--h--(—-—-+-b 


A 


V* 
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6.7 Display System Audit (AUDIT) 


The BASEWAY audit trail 
task selection/ programmed 
report can be used to view 
devices. 


records system events 
le device events# and 
specific information 


about user logins# 
other events. This 
about users and 


To display this utility# enter AUDIT from the System Status menu. 


First# type in the number of the message class you wish to see 
displayed. System messages will be displayed by default. To display 
others# clear the field first by pressing LINEFEED# and then type in 
the number of the type of message you want to see displayed. 

If you wish to change the Search Time (which defaults to today's 
date)# press TAB after typing the Message Class number. Press TAB 
again to move through the date and time fields. The date must be in 
the form day-mon—yr# and the time must be in the form hh:mn am (or 
pm). Now press RETURN to display event messages. 

Note that the most recent data is displayed on the first page of 
the screen. 


utlevthis 
page .1 of 


Display System Audit 


10:41 AM 
02-JAN-34 


1 

2 

3 

4 

5 


System Events 
Configuration Changes 
Network Events 
Gateway Events 
Programmable Device Events 


6 Session Events 

7 Data Exception Events 

8 User Application Events 

9 All Events 


Message Class >0 

Search Time> 14-JUN-84 10:41 AM 


•—r 




——— 
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! utlevthis 
'page 2 of 2 

i 

I 

04-JAN-84 
04-JAN-84 
04—JAN—84 
04-JAN-84 
04—JAN—84 
04-JAN—84 
04—JAN-84 
04-JAN—84 
04—JAN—84 
04-JAN-84 
04-JAN-84' 
04-JAN—84 
04-JAN—84 
04—JAN—84 
04—JAN—84 


Display System Audit 


10:41 AM 
02-JAN—84 


12 

52 

AM 

12 

52 

AM 

12 

50 

AM 

12 

50 

AM 

12 

50 

AM 

12 

24 

AM 

12 

24 

AM 

12 

22 

AM 

12 

22 

AM 

12 

22 

AM 

12 

10 

AM 

12 

10 

AM 

12 

08 

AM 

12 

08 

AM 

12 

08 

AM 


Connected to Device Set DEVICE SET 1 
Connected to Gateway GATE01 

Read failed in AST path to network partner node 
Lost communications with Gateway 0ATE01 
Lost communications with Device Set DEVICE SET 1 
Connected to Device Set DEVICE SET 1 
Connected to Gateway GATE01 

Read failed in AST path to network partner node 
Lost communications with Gateway GATE01 
Lost communications with Device Set DEVICE SET 1 
Connected to Device Set DEVICE SET 1 
Connected to Gateway GATE01 

Read failed in AST path to network partner node 

Lost communications with Gateway GATE01 

Lost communications with Device Set DEVICE SET 1 


Q 

k 









6.8 Display Defined Devices (DEVICES) 


This utility is accessed by entering DEVICES from the menu. 

NOTE: It may take several seconds for the screen to display the 

information. 



utldisdev 
page 1 of 1 


Display Defined Devices 11:01 AN 

14-JUN-84 

Description ; Last Updated 

Factory PLC-3 


Device Name 
ABJ3J3 


24-SEP-S4 








6.9 Display Defined Points (POINTS) 


Enter POINTS 

from the menu to 

display 

this utility 

program. 


NOTE: This 

information. 

utiIity takes 

a feu 

seconds to 

display 

the 


H— 


* utldisdev 

Display Defined Points 

12:01 PM 

! page 1 of 1 


14—JUN—84 

{ Group/Point Name 

Device Address 

Last Update 


TEST PANEL 


230 


112/1 


08—JUN—84 
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6.10 Display Defined Users <USERS> 

To use this utility* enter USERS from the menu. 

NOTE: A few seconds may elapse before this screen is displayed. 


utIdisusr 
page 1 of 1 

Full Name 

JOHN BROWN 
MARY SMITH 


Display Defined Users 

VMS User Name Nickname 

BROWN JOHN 

SMITH M 


4:01 PM 
14-JUN-84 

Last Updated 

07-JUN-S4 
08—JUN—84 
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6. 11 Display Defined Terminals (TERMS) 

Enter the letters; "TERMS" from the menu to display this utility 
tv ogram. 

NOTE: It may take several seconds before the information for 

this utility is displayed. 


utIdistrm 

Display 

Defined Terminals 

11:31 AM! 

page 1 of 1 



14-JUN-S4! 

T ermine 1 

Device Name 

Location 

Last Updated 

TTAO: 


East Bay 

OS-JUN-34 

TTBO: 


East Wall 

14-UUN-84 ! 
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CHAPTER 7 


MESSAGES 


This chapter lists 3ASEWAY software messages that can occur at 
run time. 


7. 1 Informational Messages 


APPCRE New application 

Informational. The application specified is not currently 

defined# and a new record is being created. 

User Action. Press CANCEL to stop this record from being 

defined# or press UPDATE to define the new application. 

APPDEF Application defined 

Informational. This message is displayed after the UPDATE key 

has been pressed* and indicates that a new application record has 
been written to the configuration database. 

User Action. None. 

APPDEL Application deleted 

Informational. This message is displayed after the DELETE key 

has been pressed* and indicates that the application record has 
been deleted from the configuration database. 


User Action. 


None. 



Messages 


AFPUPD Application updated 

Informational. This message is displayed after the UPDATE key 
has been pressed/ and indicates that the application record has 
been updated in the configuration database. 

User Action. None. 

CQNAPPL Connected to application 

Informational. The application M-etworfe Interface has established 
communications with another application. 

User Action. None. 

CGNDEVICE Established communications with device 

Informationa1. The programmable device has been successfully 
polled. 

User Action. None. 

CONDEVSET Connected to device set 

Informational. The application Network Interface has established 
communications with a device set. 

User Action. None. 

CQNFIGCHANGE Programmable device configuration has changed 

Informational. The program detected a difference in the 
configuration of the programmable device and the specified file. 
Possible causes are a hardware or software change on the 
specified programmble device/ or use-of a. file created from a 
programmable device different from the target programmable 
device. 

User Action. None/ if the message reflects an accurate 
situation. If the programmable device has not been changed or 
the file specified is not from a different programmable device/ 
please submit a complete SPft. 

CGNGATEWAY Connected to gateway 

Informational. The application Network Interface has established 
communications with a GATEWAY system. 

User Action. None. 

Informational. Gateway does not have an image file yet/ so the 
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utility is creating an empty/ initialized parameter file. 

User Action. None. 

JECNETDOWN DECnet has shut down 

Informational. The Network Interface has detected that DECnet 
has shut down/ and therefore/ the BASEWAY must shut down. 

User Action. None. 

DELPROC BASEWAY shutdown requested by process 

Informational. The EVENTPRGC process has determined that a 
required BASEWAY real-time monitoring process has aborted. 
BASEWAY is shutting down. 


User Action. Check the BASELINE. DMP log file in BSL$SYSTEM/ 
correct the problem. 


and 


DEVCRE 


New device 


Informational. The device specified is not currently defined/ 
and a new record is being created. 

User Action. Press CANCEL to stop this record from being 
defined/ or press UPDATE to define a new device. 


DEVDEF 


Programmable device defined 


Informational. This message is displayed after the UPDATE key 
has* been pressed/ and indicates that a new programmable device 
record has been written to the configuration database. 

User Action. None. 


BEVDEL Programmable device deleted 

Informationa1. This message is displayed after the DELETE key 
has been pressed/ and indicates that the programmable device 
record has been deleted from the configuration database. 

User Action. None. 

DEVUPD Programmable device updated 

Informational. This message is displayed after the UPDATE key 
has been pressed/ and indicates that the programmable device 
record has been updated in the configuration database. 

User Action. None. 
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ENTCRE Defining new point 

Informational. The data point specified is not currently 
defined/ and a new record is being created. 

User Action. Press CANCEL to stop the record from being defined/ 
or press UPDATE to create a new data point. 

ENTDEF Point defined 

Informational. This message is displayed after the UPDATE key 
has been pressed/ and indicates that a new data point record has 
been written to the configuration database. 

User Action. None. 

ENTDEL Point deleted 

Informational. This -message is displayed after the DELETE key 
has been pressed/ and indicates that the data point record has 
been deleted from the configuration database. 

User Action. None. 

ENTUPD Point updated 

Informational. This message is displayed after the UPDATE key is 
pressed/ and indicates that the data point record has been 
updated in the configuration database. 

User Action. None. 

FIRSTPAGE This is the first page 

Informational. You are already on the first page of the screen. 

User Action. None. 

GATDEF Gateway defined 

Informationa1. This message is displayed after the UPDATE key 

has been pressed/ and indicates that a new gateway record has 
been written bo the configuration database. 

User Action. None. 

GATDEL Gateway deleted 

Infcrmational. This message is displayed after the DELETE key 

has been pressed/ and indicates that the gateway record has been 
deleted from # the configuration database. 
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User Action. None. 

GATETMO Communications with gateway timed out 

Informational. A gateway has not responded to a message within a 
reasonable time. 

User Action. Check node for reachabi1ity. 

5ATUPD Gateway updated 

Informational. This message is displayed after the UPDATE key 
has been pressed/ and indicates that the gateway record has been 
updated in the configuration database. 

User Action. None. 

LASTPAGE This is the last page 

Informational. You are already on the last page of the screen. 
User Action. None. 

LOSTAPPL Lost communications with application 

Informational. The application Network Interface has lost 

communications with another application system. 

User Action. Check node for reachabi1ity. 

□STDEVICE Lost communications with device 

Informational. The application Network Interface has lost 

communications with a programmable device. 

User Action. Check programmab1e device network for errors. 

LOSTDEVSET Lost communications with device set 

Informational. The application Network Interface has lost 

communications with a device set. 

User Action. Check gateway for reachab i 1ity. 

LOSTGATE Lost communications with gateway 

Informational. The application Network Interface has lost 

communications with a GATEWAY system. 

User Action. Check node for reachabi1ity. 
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LOSTMSG Interprocess message lost 

Inf ormat i onal'. The Network Interface uias not able to deliver an 

• interprocess message to the proper destination mailbox. 

User Action. Check system resources* mailbox quota* etc. 

LSTPRT Listing printed 

Informational. This message is displayed after the PRINT key has 
been pressed* and indicates that a listing has been sent to the 
line printer. 

User Action. None. 

MBXFULL Mailbox full for process 

Informational. The destination mailbox for a process was full* 
and the Network Interface had a message to deliver. The message 
is lost. 

User Action. Check mailbox buffer quota. 

MGREDATA More selections follow 

Informational. There are more selections to be displayed. 

User Action. None. 

NOAPPS No applications defined 

• Informational. No applications are known to BASEWAY. 

User Action. None. 

NCDEVS No programmable devices found. 

Informationa1. No programmable devices are known to BASEWAY. 

User Action. None. 

NOENTS No points are defined 

Informational. No data points are known to BASEWAY. 

User Action. None. 

NOGATS No gateways are defined 

Informational. No gateways are known to BASEWAY. 
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User Action. None. 

NCREQS No registers defined for this device 

Inf ormati onal. No registers for this device are known to 
BASEWAY. 

User Action. None. 

NORMAL Normal* successful completion 

Informational. BASEWAY command completed successfully. 

User Action. None. 

NOSETS No device sets defined 

Informational. No device sets are known to BASEWAY. 

User Action. None. 

NOTATTACHED Programmable device not allocated by this user 

Informational. The programmable device that was specified in a 
deallocate operation is not currently allocated by the calling 
process. 

User Action. None. 

NGTRMS No terminals defined 

Informational. No terminals are known to 3ASEWAY. 

User Action. None. 

NGTSUPPORTED Function not supported by this programmable device 

Informational. The programmable device that was specified in a 
operation does not support the function. 

User Action. Try another device. 

NGUSRS No users defined 

Informational. No users are known to BASEWAY. 

User Action. None. 

REGDEF Register defined 

Informational. This message is displayed after the UPDATE key is 
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pr e 

ssed and i 

ndicates 

tha 

to 

the config 

uration 

data 

User Action. 

None. 


REGCRE 


New regi 

ster 

Inf 

ormatianal 

The r 

eg is 

and 

a new rac 

ord is b 

e ing 


REGDEL 


Register deleted 


ied is 

not 

currently 

defined* 

the record 

from being 

defined* 

ister. 



play ed 

after the DELETE key 

t the 

regi! 

jter record 

has been 


deleted from the configuration database. 

User Action. None. 

REGUPD Register updated 

Inf ormati onal. Thi3 message is displayed after the UPDATE key 
has been pressed* and indicates that the register record has been 
updated in the configuration database. 


User Action. 
ROUTERR 


None. 

Partial message routing loss—Network configuration 
error 


Informational. 


There are inconsistencies in the • System 


Definition file* the Gateway Definition file* or both. 

User Action. Correct database definitions and restart BASEWAY. 
SCRPRT Screen printed 


Inf ormational. 
been pressed* 


This message is displayed after the PRINT key has 
and indicates that the currently displayed screen 


has been sent to the line printer. 
User Action. None. 

3ETCRE New device set 


Informational. The device set specified is 
defined* and a new record is being created. 


not 


User Action. 


currently 

Press CANCEL to stop this record from being 




H 
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defined/ or press UPDATE to define a new device set. 

SETDEF Device set defined 

Informational. This message is displayed after the UPDATE key 
has been pressed/ and indicates that a new device set record has 
been written to the configuration database. 

User Action. None. 

3ETDEL Device set deleted 

Informational. This messages is displayed after the DELETE ke 
has been pressed and indicates that the device set record ha 
been deleted from the configuration database. 

User Action. None. 

SETUPD Device set updated 

Informational. This message is displayed after the UPDATE key 
has been pressed/ and indicates that the device set record has 
been updated in the configuration database. 

User Action. None. 


SHUTDOWN 


BASEWAY shutting down 


Informationa1. You requested that the BASEWAY be shut, down/ or 
recovery was not possible from previous error(s)/ so processing 
has been aborted. 

• User Action. Check previously issued messages to determine the 
cause of the problem. 


STARTUP 


SASEWAY starting 


Informational. The BASEWAY real-time monitoring processes have 
been started. 

User Action. None. 

TRMCRE New terminal 

Informational. The terminal specified is not currently defined/ 
and a-new-record is- being created. 

User Action. Press CANCEL to stop this record from being 
defined# or press UPDATE to create a new terminal. 


TRMDEF 


Terminal defined 
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Informational. This message is displayed after the UPDATE 
has been pressed/ and indicates that a new terminal record 
been written to the configuration database. 

User Action. None. 


TRMDEL 


Terminal deleted 


Informatianal. This message is displayed after the DELETE 
has been pressed/ and indicates that the terminal record has 
deleted from the configuration database. 

User Action. None. 

TRMUPD Terminal updated 

Informational. This message is displayed after the UPDATE 
has been pressed/ and indicates that the terminal record has 
updated in the configuration database. 

User Action. None. 

UPDGATVDR Updating database for gateway 

Informational. The editor is rebuilding the memory-resi 
database for the specified gateway because you have modified 
gateway data structures. 

User Action. None. 

USRDEF User defined 

Informational. This message is displayed after the UPDATE 
has been pressed/ and indicates that a new user record has 
written to the configuration database. 

User Action. None. 

USRDEL User deleted 

Informational. This message is displayed after the DELETE 
has been pressed/ and indicates that the user record has 
deleted from the configuration database. 

User Action. None. 

USRUPD User updated 

Informational. This message is displayed after the UPDATE 
has been pressed/ and indicates that the user record has 
updated in the configuration database. 
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User Action. None. 

VDRCHG Programmable device database changed/ 

1. The gateway VDR database has been 
figuration data. The VDR image file ha 

User Action. None. 

vDRUPD Gateway VDR image file updated 

Informatianal. The gateway VDR image file has been 
the new configuration data. 

User Action. None. 

ZEROED Message counters cleared 

Informational. The Network Interface received and 
processed a Reset Network Counters message. 

User Action. None. 


Informationa 
the new con 
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s not yet been 


updated with 


successfully 
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7. 2 Warning Messages 

4PPNAMUSD Application name already in use—select another name 

Warning. When renaming an application# you selected a name that 
is already being used. 

User Action. Select a different name# and try defining again. 

APPREACHABLE Unable to delete—application currently reachable 

Warning. You tried- to delete an application that was currently 
reachable. Applications may not be deleted when they are 
running. 

User Action. Shut down the application before trying to delete 
it from the BASEWAY database. 

ATTACHED Programmable device allocated to another user 

Warning. The programmable device that was specified is currently 
being used by another user. 

User Action. Try again later. 

3ADA0DR Invalid address for this programmable device 

Warning. An address is in an invalid format or outside the range 
of legal addresses for this model of programmable device. 

User Action. Specify correct address. 

3ADFMT 3ad format name—try again 

Warning. The format name specified is invalid for the device 
address. 

User Action. Try another format specifier# or press SELECT for a 
list of valid formats for this address. 

3ADMGBEL Invalid model for current function 

Warning. The model specified is invalid for the current 
operation. 

User Action. Specify a valid model. 

DEVADRUSED Device network address already in use—select another 

address 
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Warning. The programmab1e device communication network that was 
specified is already being used by another device. 

User Action. Select a different address/ and.try defining again. 

vEVNAMUSD Device name already in use—select another name 

Warning. When renaming a programmable device/ you selected a 
name that is already being used. 

User Action. Select a different name/ and try defining again. 

ENTNAMUSD Point name already in use—select another name 

Warning. When renaming a data point/ you selected a name that is 
already being used. 

User Action. Select a different name/ and try defining again. 

GATNAMUSD Gateway name already in use—select another name 

Warning. While renaming a gateway/ you selected a name that is 
already being used. 

User Action. Select a different name/ and try defining again. 

GaTREACHABLE Unable to delete—gateway currently reachable 

Warning. You tried to delete a gateway that was currently 
reachable. Gateways may not be deleted when they are running. 

User Action. Shut down the gateway before trying to delete it 
from the BASEWAY database. 

ILDATE Invalid date specified 

Warning. You typed the date in a format that is not recognized. 

User Action. Enter the date correctly. 

ILMEMSIZE Invalid memory size for this device—try again 

Warning. You specified a memory size that is outside the range 
of valid memory sizes for this programmable device. 

User Action. Verify the proper memory size/ and reenter the 
value. 

ILMENUDATA MENU form has an invalid command in NAMED DATA for this optic 

Warning. The current menu form specifies an action to be taken 
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for this command; but it is not recognizable to BASEWAY. 

User Action. Check the format of the NAMED DATA entry for this 
option. 

ILMENUFORM Form not a valid MENU form 


Warning. The VAX FMS form that was to be displayed on 
terminal is not a valid BASEWAY menu form. 


your 


User Action. The 
with the field 
‘•select 11 . If nei 
unusable. 


BASEWAY menu program looks for a VAX 
"choice 11 ; or a series of indexed fi 
ther of these exist; then the form 


FMS form 
elds named 
is deemed 


ILNUM 

Warning, 
the valid 

User Acti 


Entry out of range—try again 

The user typed a numeric response 
1 imi ts. 

on. Enter the number correctly. 


that 


is not within 


ILTIME Invali 

Warning. You typed 
User Action. Enter 
NODEINUSE ■ DECnet 


d time specified 
the time in a .format that 
the time correctly, 
node already referenced 


is not recognized. 


Warning. You entered a DECnet node name twice for the same 
app 1 i cation. 

User Action. Enter a different DECnet node; or press Update. 

NODGWNFILE Unable to open download file 

Warning. The program was unable to open the specified download 
file. Possible problems are: improper file quotas; improper 

file or directory specifications; file protection violations; 
file “locked; insufficient privileges; or invalid logical name 
assignments. 

User Action. Check for problems specified in explanation and try 
again. 

NOHELP No help available 

Warning. You have tried to get online help for a function that 
does not have any help messages defined. 
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